Welcome to ForcerIcon v1.1. This is a short description on how to use the program and how to configure it. ForceIcon is a utility mainly written for users of CDRom drives.

Have you ever tried to Snapshot the disk icon (Disk.info) or tried to replace the disk icon of a CDRom ? Well, if not, do not even try, CDRom drives are read only media (how come). This is where ForceIcon comes to use. You may tell ForceIcon which volumes/devices to snoop/trace for forcing abolute positions or images.

ForceIcon is © 1993 Kai Iske, GiftWare

The UserInterface was built using GadToolsBox 2.0c (37.300) by Jan van den Baard

Copyright
*********

You are allowed to copy and spread this program but only if you do not make any commercial profit out of the program itself and all supported files. The source of ForceIcon is considered teachware and the author claims the right to be the only one to produce and distribute new versions of ForceIcon. Public Domain vendors are not allowed to sell ForceIcon for more than the price of a regular disk, which should not be higher than 5 Dollars.

ForceIcon is GiftWare, so if you like it and you you want to express your feelings, feel free to send me anything you think of being suited. Postcards, cookies, money, simply anything ;)

Guarantee
*********

The author does not give any guarantee that the program ForceIcon works perfectly. The program was tested and it is used every day, anyway nobody is perfect and that is why I can not take the responsibilty for any damages occured during the usage of ForceIcon.

Evolution
*********

When I bought my CDRom drive I found out that the Workbench chooses quite stupid positions for icons with no abolute position (from my point of view). Furthermore some CDRom publishers do not seem to care for good looking disk icons (again, from my point of view; if they even supply one). Since I could not snapshot the supplied icon, nor replace it with one of my icons, I thought it would be a good idea to have an utility which does the "snapshotting" or "replacment". This was when ForceIcon came to live.

ForceIcon allows the user to select positions for his/her Disk.info files, either device dependant or volume dependant, ie. ForceIcon will either monitor all volumes inserted into a device, or just those specified by the user. It is also possible to override the settings for a device if you specify the name of a volume, too.

Whom I must say 'thank you'
***************************

I would like to thank the following people

Martin Taillefer

     For answering several questions

Olaf 'Olsen' Barthel

     For suggestions and beta-testing

Ralph Babel

     For suggestions on how to implement device dependancy and for pointing me to a "bug".

My girlfriend

     Who accepts what I`m doing

     ...and all the others I forgot

How to obtain updates
*********************

ForceIcon will be available on ADS, FRAS, FTP, and Fred Fish disks (CDs) as soon as there is a new release available.

How to contact the author
*************************

If you have any questions, suggestions, bug reports or anything else you want to tell me, you may contact me under one of these addresses.

Either use normal snail mail:

     Kai Iske
     Brucknerstrasse 18
     63452 Hanau
     Germany
     Tel.: +49-(0)6181-850181

or reach me using electronical mail

     USENET:   kai@iske.adsp.sub.org
     INTERNET: iske@informatik.uni-frankfurt.de
     FIDO:     Kai Iske, 2:244/6302.11
     ZNET:     KAI@SWEET.ZER

Installing ForceIcon
********************

Installing ForceIcon is not that hard. Simply copy it to your SYS:WBStartUp drawer (including the supplied icon), or place it somewhere else and start ForceIcon from within your S:User-StartUp file. I suggest you better start ForceIcon from within S:User-StartUp, so that ForceIcon may apply all patches before Workbench is loaded.

When starting from within S:User-StartUp issue the following line :

Run <NIL: >NIL: ForceIcon

You may configure ForceIcon using the following ToolTypes/CommandLine options.

CX_PRIORITY=n

     Sets the priority for the program`s section which controls the HotKey. If you issue a priority > 0 it may be that HotKeys initialized by other programs may not be reached anymore if ForceIcon uses the same. Default: It`s neutral 0.

CX_POPUP=YES|NO

     Per default the control window will be opened on startup. You may suppress this behaviour by issuing CX_POPUP=NO

CX_POPKEY=s

     Using this option you may override the default settings for the openup HotKey. This HotKey is used to open the control window. Default HotKey definition is lalt lshift i. See HotKey definition, for more about describing a HotKey.

These options may be used within the icon`s ToolType field or on the CommandLine.

HotKey definition
=================

To ease the definition of a HotKey here is a list of key-descriptions the system ''knows''.

Here is a list of qualifiers.

ALT
     Any Alt key.

RALT
     Only the right Alt key.

LALT
     Only the left Alt key.

SHIFT
     Either Shift key.

RSHIFT
     The right Shift key.

LSHIFT
     Only the left Shift Key.

CAPSLOCK
     Capslock must be pressed.

LCOMMAND
     Left Amiga key.

RCOMMAND
     Right Amiga key.

CONTROL
     Control Key.

NUMERICPAD
     Keys of the Numeric Keypad are accepted.

RBUTTON
     Right mousebutton.

MIDBUTTON
     Middle mousebutton.

LEFTBUTTON
     Left mousebutton.

NEWPREFS
     Preferences have been changed. Maybe a new font was selected.

DISKREMOVED
     A disk was removed from a drive.

DISKINSERTED
     A disk was inserted into a drive.

These are the qualifiers you can use in almost every combination. Now we come to the descriptions of ''normal'' keys.

A - Z, 0 - 9, etc.pp.
     Normal keys, as you see them on the keyboard.

F1 - F10
     The ten function keys.

UP, DOWN, LEFT, RIGHT
     The cursor keys up, down, left, and right.

HELP
     The Help key.

DEL
     Delete key (beside HELP).

BACKSPACE
     Backspace key

RETURN
     Return key.

ENTER
     Enter on Numeric Keyboard (only, if NUMERICPAD was specified).

ESC
     Escape key.

SPACE
     Space.

COMMA
     A comma.

UPSTROKE
     The apostroph (to the left of the 1).

You can use as many qualifiers as you wish, but only one key per description. This is the syntax for a HotKey definition:

[QUALIFIER [QUALIFIER ...]] KEY

As you can see the qualifiers can be totally left out, but in how far this is usefull depends on you. Entering "None" (without quotes) will disable a HotKey.

Using ForceIcon
***************

From within the main window you may configure ForceIcon to suit your needs and disks.

On the right side of the window you will notice a ListView gadget showing all available volumes/devices currently known to the system. From this ListView you may select the volumes/devices to apply changes to. Simply select an entry and click on the Add to list gadget and the selected volume/device will be copied to the left ListView gadget named 'Used Volumes/Devices'. You may copy an entry to the select-list by double-clicking on it, too. If the selected entry has already been added to the list, a requester will pop up giving a warning. If a volume/device is not mounted yet you may add it`s name to the 'Used Volumes/Devices' list by clicking on Add manually.... A window will pop up, containing a String gadget. Simply enter the new entry`s name without a trailing colon. Selecting Ok will copy the entered volume to the 'Used Volumes/Devices' list, as long as it is not there yet. 'Cancel' will simply abort. You may determine the type of entry using the Type gadget. The third gadget underneith the 'Available Volumes/Devices' ListView called Rescan list may be used if a volume/device has been mounted after the main window has been opened.

Underneith the 'Used Volumes/Devices' ListView there are two Button gadgets. Selecting Edit entry..., or double clicking on an entry will open the 'Edit entry' window (see EditEntry). The second gadget labeled Remove from list, will simply remove the selected entry from the 'Used Volumes/Devices' list. The Text gadget right underneith the ListView will tell you about the type of entry currently selected.

Every time an entry is added to the list, the list will be sorted, so that volumes are shown first. This is due to the fact, that volumes have a higher priority over devices, so that you may force a volume`s icon to an other position than the position specified for the device, the volume was mounted from.

The five gadgets at the bottom of the window are to be used as follows:

Use

     Will copy the current settings to ENV:ForceIcon_prefs.iff, thus leading to temporary storage.

Save

     Will copy the current settings to ENV:ForceIcon_prefs.iff and to ENVARC:ForceIcon_prefs.iff, thus leading to permanent storage of your settings.

About

     Displays about notices

Hide

     Will close all windows.

Quit

     Will close all windows and remove ForceIcon from memory.

Edit an entry
=============

This window may be used to edit an entry. The first gadget is a String gadget, which may be used to change the volume`s name, say the name of the volume/device ForceIcon will react on. The Cycle gadget (Type) underneith the String gadget allows you to change the type of entry you are editing. Below there are two Integer gadgets showing the current position of the disk icon of the selected volume. You may either set a position manually, or use the 'Position window', but only if you select IconPos. If this gadget is not set, ForceIcon will force the loaded icon to have a position of NO_ICON_POSITION, say it will let the WorkBench position the icon. This might be usefull to override hardcoded positions. The position window may be opened using the Position Cycle gadget. Clicking on it once will open the window, whilst another click will close it again. Open the 'Position window' and drag it around your workbench. The values shown within the Number gadgets will be updated as soon as you release your left mouse button. Using this method you may determine the position of a disk`s icon on Workbench, too.

Now following are three more gadgets which determine the image of the selected volume`s icon. Using the String gadget labeled Icon, you may set a name for a .info file which should be used, instead of the volume`s Disk.info, or it will be used if the volume does not even have a Disk.info. Clicking on the GetFile gadget or holding down SHIFT while hitting the String gadget`s shortcut will open up a Filerequester, so that you may select a .info file using a more convenient method. These two gadgets are only available if the following gadget is set. Finally, the Use Icon gadget determines, whether the supplied icon should really be used, or not. You do not have to worry about the type of the selected .info file. ForceIcon will automatically apply all changes to the icon, so that it will be a real disk icon. These changes are applied during runtime. The file will not be modified on disk.

Program history
***************

     Revision V1.1
     --------------
     created on Tuesday, 02.11.93 23:11:14  by  Kai Iske.   LogMessage :
      -*-  changed on Saturday, 27.11.93 02:12:59  by  Kai Iske.   LogMessage :
       - Recompiled using SAS 6.50
      -*-  changed on Saturday, 20.11.93 18:14:21  by  Kai Iske.   LogMessage :
       - ForceIcon will adopt the orig. window position and size now.
         (Suggested by : Michael 'Mick' Hohmann and me)
      -*-  changed on Saturday, 20.11.93 18:03:08  by  Kai Iske.   LogMessage :
       - Icons weren`t positions as set with the Position window.
         (Reported by : Michael 'Mick' Hohmann)
       - Misleading explanation removed from docs
         (Reported by : Michael 'Mick' Hohmann)
      -*-  changed on Saturday, 20.11.93 17:33:51  by  Kai Iske.   LogMessage :
       - The X/Y coordinates may be set manually, now.
         (Requested by : Michael 'Mick' Hohmann)
      -*-  changed on Saturday, 20.11.93 17:24:20  by  Kai Iske.   LogMessage :
       - Edit Entry window`s gadget used 'I' twice
         (Reported by : Michael 'Mick' Hohmann)
      -*-  changed on Thursday, 11.11.93 18:43:27  by  Kai Iske.   LogMessage :
       - You may now tell ForceIcon not to patch the position, but
         rather let WB chose a good place. (Good when importing
         volumes via network)
      -*-  changed on Tuesday, 02.11.93 23:23:00  by  Kai Iske.   LogMessage :
       - ListView gadgets weren`t adjusted for OS 2.x. - Should check
         for OS 2.x sometime ;)
         (Reported by : Bernhard Moellemann)
       - Changed needed Versions of some libraries from 37 to 36
      -*-  created on Tuesday, 02.11.93 23:11:14  by  Kai Iske.   LogMessage :
       - If there wasn`t a filename for the Icon-File the
         FileRequester sometimes showed a weird Drawer-Name
         (Reported by : Dirk Federlein)

     Revision V1.0
     --------------
     created on Wednesday, 20.10.93 17:19:27  by  Kai Iske.   LogMessage :
      -*-  changed on Thursday, 28.10.93 17:35:28  by  Kai Iske.   LogMessage :
       - Suggestions for device dependancy by Ralph Babel
       - Bug "found" by Ralph Babel
       - Pos window used to open on default pubscreen, not on WB.
         (Reported by : Bernhard Moellemann)
      -*-  created on Wednesday, 20.10.93 17:19:27  by  Kai Iske.   LogMessage :
         --- Initial release ---